home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / os2 / timidos2.zip / README.OS2 < prev    next >
Text File  |  1997-06-03  |  4KB  |  83 lines

  1. TiMidity-0.2i port to OS/2 Warp with DART and PM support
  2. --------------------------------------------------------
  3. June 3, 1997
  4.  
  5.      To get this to play MIDIs in real time you'll need to have DART
  6. (Direct Audio Real-Time) working on your computer.  If you have OS/2
  7. Warp 4, you're set.  If you have version 3, what you need, accourding
  8. to IBM, is have FixPak 10 or greater installed.  You can check this by
  9. doing a VER /R at the command line and if the revision number is more
  10. then 8.234 then you do.  If you don't you can get the lastest FixPak
  11. at href="http://ps.software.ibm.com/pbin-usa-ps/getobj.pl?/pdocs-usa/
  12. os2warp.html  It will not work on any OS/2 version before 3.
  13.  
  14.      The driver has a buffer that's a couple of seconds in size, so if
  15. you do something, like open a folder, the sound may not suffer.  The
  16. size of the buffer is set with the "-B n" where n is the number of
  17. buffers.  The default number of buffers is 40.
  18.  
  19.      If the program is getting behind the program will dynamically
  20. increase it's priority.  If it's still falling behind setting the
  21. resampling frequency to something lower will help.  This is done with
  22. the "-s f" switch where f is the new resampling frequency.  I
  23. sometimes find that it sound will be distored when the computer is
  24. working, even there is enough in the buffer.  I think this is cause by
  25. the fact that it can't send the next buffer to the sound card when the
  26. computer writing to an accelated video card.  Lowering the resamplling
  27. frequency helps with this, too.  The default for the OS/2 version of
  28. TiMidity is 22050.  A value of 11025 is good.  Other values will work
  29. if your sound card supports it.
  30.  
  31.      The format values supported include 8 and 16 bit sample widths
  32. (using 8 bit will not improve performance, TiMidity generates 32 bit
  33. data and has to reduce it in any event).  You can select mono or
  34. stereo.  Using mono does improve performance.  Selecting Signed,
  35. Unsigned or Byte-swapped will be overriden with the DART driver.
  36. Using the default of 16 bit stereo will should work fine for most
  37. people.
  38.  
  39.      The SLang interface only displays as many lines of messages from 
  40. TiMidity as it has room on the screen. You can switch to the old 
  41. simple interface with -id or, better yet, use -ist to get a fancy 
  42. display of the notes being played, although the display is quiet a bit
  43. ahead or what you hear. You can reduce that lag by setting the -B n 
  44. value to something low, like 3.
  45.  
  46.      There are some minor problems, none of which are my fault :-).
  47. First every time the program ends gives two MMOS/2 errors about an
  48. invalid device ID given.  It does this because the main TiMidity
  49. program calls the sound driver closing function twice.  The first time
  50. it closes properly, the second it gives errors.  It's nothing to worry
  51. about.
  52.  
  53.      TiMidity can generate .wav files, but it does 16 bit .wavs
  54. wrongly.  If you got a hankering to make a .wav file you can force it
  55. generate 8 bit data and that'll work.  The .wav file system was not
  56. written by me. The MS-DOS version of TiMidity does generate proper 16 
  57. bit. If I had half a mind I'd get it working in OS/2 the same way.
  58.  
  59.      Often when it finished playing a song it'll say "Output Flush
  60. timed out".  This means that it was waiting for the buffer to empty,
  61. but it never figured out when it did.  This may sometimes cause a bit
  62. of silence between songs, but that's all.  This problem may be my
  63. fault.
  64.  
  65.      If you have any questions or comments, please email me at
  66. doconnor@autobahn.mb.ca and watch
  67. http://www.autobahn.mb.ca/~doconnor/timidity.html for updates.
  68.  
  69.      TODO:  Make it a MMOS/2 device.  (so you might be able to get
  70. TiMidity to play the Midi inbedded within OS/2 games).  Use DSMI
  71. (Timidity has it's own mixer right now).
  72.  
  73. -----
  74.  
  75.      On a personal note, and I'm not sure if this is appropriate, I'm
  76. interested in jobs where I'd have the opportunity to program for OS/2
  77. or, possibly, be involved in writing a compiler.  This is not a plea
  78. as I'm currently quite gainfully employed as a computer programmer-
  79. consultant.  I am a Canadian and I'm not interesting in going to the
  80. United States unless it was a really interesting job (like working for
  81. StarDock).  Other countries I may give a bit more consideration to.
  82. You can email me at doconnor@autobahn.mb.ca
  83.